为你的 App 添加功能

“功能”让你的 App 能够访问 Apple 提供的“App 服务”，如 CloudKit、Game Center 或 App 内购买项目。要使用某些 App 服务，你必须对 App 进行预置，通过 Xcode 的项目编辑器添加功能，而项目编辑器会为你正确配置相应的 App 服务。Xcode 会编辑“Entitlemen”(授权 (英文)) 和信息属性列表 (英文) 文件，添加相关的框架，并配置你的签名素材。

不过，一些 App 服务 (如 Game Center 和 App 内购买项目) 需要在 App Store Connect 和你的开发者账户中进行额外配置。例如，如果 App 使用“地图”为其他 App 提供路线指引，你需要使用 App Store Connect 上传地理覆盖范围文件。

App 所面向的平台以及你有无 Apple Developer Program 的会员身份，都可能会限制 App 可使用的功能。有关受支持的功能，请参阅《开发者账户帮助》的“参考”部分。例如，可查阅“受支持的功能 (iOS)”来了解 iOS App 可以使用的功能。

在开始之前，请先添加你的 Apple ID 账户 并将项目分配给团队，让 Xcode 能预置你的 App。对于 iOS、Apple tvOS 和 watchOS App，请在设备上运行你的 App，以便注册设备并创建开发预置描述文件。

重要信息

从模板创建项目时，请使用默认的自动签名。如果手动为 App 签名，你必须自行完成功能配置步骤。

你可以使用项目编辑器的“Signing & Capabilities”(签名和功能) 面板来为 App 添加功能。

在主窗口的项目导航器中，选择所需项目 (名称与你的 App 相同的根组)，然后在右侧显示的项目编辑器中选择所需目标。从“Project/Targets”(项目/目标) 弹出式菜单或大纲视图的“Targets”(目标) 部分中，选取 App 的目标。然后，点按项目编辑器中的“Signing & Capabilities”(签名和功能) 标签。

你也可以选择一个构建配置 (“All”(全部)、“Debug”(调试)、“Release”(发布))。例如，如果你只想将功能添加到“Debug”(调试) 配置，请选择“Debug”(调试)；否则，请选择“All”(全部)。

在工具栏中，点按“Library”(资源库) 按钮 (+) 以打开“Capabilities”(功能) 资源库 (也可以点按构建配置左侧的“+ Capability”(+ 功能) 或选取“Editor”(编辑器) >“Add Capability”(添加功能))。“Capabilities”(功能) 资源库仅显示目标平台和你的计划会员资格可以使用的功能。

要查看各项功能的描述，请点按资源库右上角的“Show Details”(显示详情) 按钮。在左侧选择一项功能，即可在右侧阅读对应的描述。

要将功能添加到 App 目标中，请在资源库中双击这项功能，或将这项功能从资源库拖到“Signing & Capabilities”(签名和功能) 面板上。这项功能便会显示在“Signing”(签名) 部分下。如果有更多配置步骤，功能会展开来显示其他控件 (请参阅“完成其他配置步骤”)。要移除某项功能，请在“Signing & Capabilities”(签名和功能) 面板中点按该功能右上角的“X”按钮。

如果“Signing”(签名) 部分显示错误，请阅读显示的信息，更正问题，然后点按“Try Again”(重试)。例如，“Signing”(签名) 下“Bundle Identifier”(套装标识符) 栏位中显示的套装 ID (CFBundleIdentifier (英文)) 必须独一无二。套装 ID 的默认值是组织标识符加上你在创建项目时输入的 App 名称。

对于一些功能，你可能需要在 Xcode、你的开发者账户或 App Store Connect 中完成其他配置步骤。对于另一些功能，你可能需要编写一些代码。

如需特定功能的更多指导，请参阅下表。

功能

其他信息

App 小组

配置 App 小组

Apple Pay

Apple Pay 设置要求 (英文)

App 沙盒

配置 App 沙盒 (macOS)

关联域

支持关联域 (英文)

后台模式

配置后台模式 (iOS、Apple tvOS、watchOS)

ClassKit

在你的 App 中启用 ClassKit (英文)

字体

配置用户字体

游戏控制器

配置游戏控制器 (Apple tvOS)

强化版运行时

强化版运行时 (英文)

HealthKit

设置 HealthKit (英文)

HomeKit

配置 HomeKit (iOS、Apple tvOS、watchOS)

iCloud

启用 iCloud 键值存储、文稿存储或 CloudKit

App 内购买项目

App 内购买项目配置流程

钥匙串共享

在一系列 App 之间共享钥匙串项目访问权限 (英文)

地图

位置和地图编程指南 (英文)

网络扩展

配置网络扩展

支持按需安装

通过 Xcode 创建轻 App (英文)

推送通知

设置远程通知服务器 (英文)

通过 Apple 登录

关于“通过 Apple 登录”

Siri

创建意图 App 扩展 (英文)

钱包

钱包开发者指南 (英文)